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1 Document Management 

1.1 Legal Disclaimer 

E2open~, Its members, officers, directors, employees, or agents shall not be liable for any 
Injury, loss, damages, financial or otherwise, arising from, related to, or caused by the useof 
thi$ document or the specification* heiein, as well a* associated guidelines and schema*. The 
use of said specifications shall constitute your express consent to the foregoing exculffction* 



1.2 Copyright 

Copyright © 2003 E2open Inc, All rights reserved. No part of this publication may be 
reproduced, stored in » r«ui«val system, or transmitted, In any form or by any means, 
electronic, mechanical, photocopying, recording, or otherwise, without the prior written 
permission of the publisher, Printed In the United States of America. 

1.3 Trademarks 

tzopen is a trademark of "EZopen LLC". All uili«i product names and company logos mentioned 
herein are the trademarks of their respective owners. In the best effort, all terms mentioned In 
this document that are known to be trademarks or registered trademarks have been 
appropriately recognized in the first occurrence of the term. 



Trademark or Registered Trademark 
OU-N-S Data Universal Numbering System 

G7IN Global Trade Identification Number 

GLN Global Location Number 

Rosette Net 



tampanvor Qrgar»te?ftw 

Dun & Bradstreet 
EAN-UCC 
EAN-UCC 
Rosetta Net 



1.4 Prorequiaites 

1.5 Related Documents 

References to other related documents. 




Copyright <§> 2002 E2opert LLC. Proletary and Confidential 



9^ 



E2open Collaboration Managar 



1.6 Document Vers! n History 



IjOl 



I Initial VflfSkX) - Prev fo Slngha!. 



1.7 Document Distribution History 
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2 Overview 

•mis document describes the design of File Transfer (FT) Service. The FT service isdeslgned 
to efficiently handle transfer of large files over Internet. Large files cannot be transferred 
over Internet in a single synchronous operation reliably and efficiently. There are a number 
of problems that result from attempting to transmit large files In a single, synchronous 

l^^ansmls^on of such a large file may consume all the available network bandwidth 
Detween Uie customer end E2open- This is particularly troublesome for remote locations 
with lightweight network connections. 

2. File transfer operations that take hours to complete are prone to failure. If anything goes 
wrong with the network connection during the N hours it may take to transfer a large flle f 
the entire file transfer operation may have to be aborted and re-started ■ 

rhe idea behind FT *at vice Is to transmit the file In smuUor manageable chunks and 
reassemble the chunks as they arrive at the other end. If any end becomes unavailable 
during a transmission or the network connection breaks, transmission resumes from where tt 
left. 

3 Highlights 

The File transfer mechanism consists of 2 mam components. 

• File Transfer (FT) Gateway: The FT Gateway is Installed at a customer's site, 
o Initiates an upload or download transfer request for a file, 
o CommuntC8tes with the FT Server via E2open's webseal using HTTPS. 
o Connects to E2open using user session (E2open user or CDSSO user) or can 

be set up to use client side certificate, 
o Support* multiple transfers concurrently. Multiple upload and download 

operations can proceed concurrently, 
o Transfers multiple chunks of the same file concurrently. It can also be 

configured to use more than one thread per transfer (preferable In the 

presence of a fat pipe), 
o Dynamically creates logical chunks of the file during transfer. The file is 

not physically chunked. Due to this 

■ No extra disk space is required for temporary physical file chunks. 

■ Boost* performances as no CPU or I/O time spent in creating these 
chunks. 

o Allocates the disk space for the me to be downloaded ones the 

download tr ansfer session to setup. This prevents the client from running 
out of disk space during the transfer, 
o Transfer session extends across both FT Client and FT Server restarts. 
« Supports both dlent and server initiated downloads. 

• In client Initiated download (Client push), the client sends a download 
request and then keeps polling till the server has the file ready to be 
downloaded. 
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- In server initiated download (Client pull), the dlent does not send any 
download request but simply polls to check If the server has any file for 
this user to be downloaded. , . - 

o Provides means to attach metadata on a transfer operation. This metadata is 
delivered to the adapter during the session setup time. This metadata could 
contain Information about the transfer. For example, In thin dient FT solution, 
the metadata contains information about the workspace, folder and document. 

o Provides a Java API to write FT Gateway services. For each Gateway service, 
there exists an Adapter on the FT Server side to service the transfer. Multiple 
services can be plugged into a single instance of the FT Gateway. 

o Can be deploy*** In either entmrprism mode or thin dlent mode* In 
enterprise mode, multiple users can use a single Instance of the Gateway to 
transfer files to/from E2open. An example of this mode is pom Gateway (POM 
service + FT Gateway deployed on the Edgebox). In thin client mode, the 
session always belongs to a single E2open user. In this mode, It can be 
deployed on customers' desktop. 

o Stickiness to m particular FT Server Is only at the transfer session level 
and not at the FT Gateway level. This enables multiple FT Servers to be 
deployed In a clustered environment. 

o Provides an audit log for all transfer through the FT Gateway. 
< EMBED Visio-Drawing.6 > 

• File Transfer (FT) Scrvertlt is Installed at Elopen hub. 
o Deployed behind E2open'* WehseaL 

o A single instance of the FT Server can handle both thin dlent FT gateway and 
enterprise FT gateway. 

o Responsible for creating transfer session. Although FT Gateway Initiates the 
transfer, the sessions are created only at the server. All transfers need to have 
a valid server side transfer session* 

o All cHent side transfer related parameters (QOS parameters like Me 
size, maximum chunk size, time to live etc) are validated at the server 
side. This enables the FT server to dictate the maximum size of the file that 
can be uploaded, maximum size of a file chunk, maximum a*piry time, etc. 

o Validate every http transfer request for security* 

o Allocates the disk space for the file to be uploaded at the time of 
creating the transfer session. If the server runs out of space, it sends a 
retry time to the dlent. Enhancement: Since the fife server is a shared 
resource, It would be nice If the FT Server can manage and be configured with 
a disk quota. 

o Re-assembles the chunk dynamically Into the file without creating 
extra physical chunks. Since the dient can send multiple chunks of the 
same file concurmnUy, the server is capable of handling chunks that come out 
of sequence. 

o Handle multiple uploads and downloads concurrently for the same user or for 
different users. 
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o Provides a Java API to write FT Server Adapters. Multiple adapt** can be 
plugged Into a single Instance of the server. An adapter exists for each FT 
Gateway service. ^ , , . . 

6 For an Upload operation, the file transfer is done when the file has been 
successfully assembled at the server end. But the transfer is completed only 
when the transfer has been serviced by the adapter. If tfteserver restarts 
after the transfer has been done but before It could be successfully serviced or 
the adapter could not successfully service the transfer operation, the server 
will retry to service the transfer operation after a configurable interval. This 
will continue till the service operation succeeds or the transfer operation 
expires. This provides reliability and guarantee of transfer. 

4 Design 

The File Transfer Service i3 designed to reliably transfer small and large flies over the 
internet to and horn E20pen. The service Is based on a service oriented model to support 
both thin clients (that live on user's desktop) and enterprise clients (that live on backend 
servers). 

The FT Service is designed In a service-adapter model. This model allows the FT service to be 
us6d simultaneously for various purposes. Services are deployed on the FT Gateway and the 
adapters are deployed on the FT Server. For every service, there Is a corresponding 
adapter, thus creating a virtual channel. Transfer operations take ptaoe within this 
virtual Channel. A customized service and adapter can be developed to use the FT service 
for a specific purpose like POM Integration. Multiple services/adapters can be deployed on 
the single Instance of the gateway/server 



FT Gateway 



Service A 
' I 



Service B 



virtual Channel A 



Virtual Chann** ft 



FT server 



— > Adapter A | 



> Adapter B~] 



4.1 FT Protocol Messages 

# EstabllsnLoginSessfon: This message Lakes the users login W and login password 
and attempts to login into E2cpen via WebSeaL On a successful login, a user session 
is created and cached In-memory- Depending upon the Gateway configuration, this 
message may use etcher the regular C20pen login or cdsso. Also, as a part of 
response to this message, the server informs tho client about the number of 
concurrent transfer sessions it is allowed. Currently, this returns a constant 
number from the server configuration. 
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TransfcrContextMessag : This message is used by the Gateway to establish a 
client transfer session with the FT Server. QOS management Is also achieved with 
this message- Important values negotiated at this time are: 

- Maximum Rle Size. 

- Maximum Chunk Size 

« Maximum Time to live I.e. the duration for which this transfer is vaua. 

- Maximum number of threads a dlent can use for concurrent transr ei of 
chunks. 

The dlent only recommends the above values. The FT server dictates the final 
values of these attributes. This requests also contains other transfer information 
such as user-Id, client task Id, filename, any metadata specified at the time of 
submission of transfer request by the Gateway service etc. This message uses the 
SOAP on HTTP transport mechanism. The session attributes are sent in the xml 
part and the metadata as attachment. On receiving this request, the server 
a Validates the transfer request from the gateway. The server could deny the 
request on grounds, such as file size Is more than the maximum permitted tile 
Size, server out of disk space, server Is busy etc 
o The server then tries to validate the transfer request with the corresponding 
adapter. It is up to the adapter Implementation to validate the transfer 
request For example, the PDM adapter validates the Seagate Global ID with 
LDAP and than checks if the user has a valid CM account. Another e.g. - in 
case of a download operation from CM, the adapter could try to checkout the 

file for download. „ TJ 

o On a successful validation, the server creates * transfer session Id for tniS 
transfer operation. Also, If the transfer Is an upload operation, then the server 
pre-allocates the space by creating a transfer file for this session. As a part of 
the response attribute, the server sonde the transfer session Id. The Client 
needs to use this session Id in all subsequent requests for this transfer 
operation. 

o If the validation failed, the server returns an appropriate error. Depending 
upon error, it may return a retiy-interval after which the gateway can try to 
resubmit the transfer request. 
ChunkFUaMmssagu; This message doea the actual transfer of payload. A 
ChunkFlleMessage object is created for every We chunk to be transferred. This 
message uses basic HTTP transport mechanism. In an upload transfer, the payload is 
sent as the request body and In download transfer, the payload is in the response 
body. The message attributes define the transfer session Id, chunk number, total 
bytes in the chunk etc. The server on receiving and validating this message 

o For an upload operation, takes the payload and streams It to the transfer file 

at the right offset. There is no temporary file created, 
o For a download operation, the server takes the chunk bytes from the file and 
streams them as a part of the response body. 
EndTransferMessage : The gateway sends this message when it determines the 
transfer has been completed. On receiving this message, the server cleans up the 
resources associated with the transfer session. 
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/>^ MmM »MMeaae' This message Is used by the gateway to poll tor a respoftw 
* SISKSSK uiS™ TSSStlon has been completed. This message is only 
23 oneway service guested a ^^^pter on *e 

completion of the transfer. The gateway polls for the^po^from tt>e server at a 
configurable Interval (and overridden by the retry-Inter^l from ^^Oncea 
revived and processed by the gateway service, uie y^^y W¥VJ 

. S2S,,: only In the enterprise mode, on the request of the service, 
fh^Tway^H, the^rver to check if the user has any ">ess8ge that needs to be 
downloaded For this, the service has to register the ^^^^^ 
which it has to poll. The polling rate is configurable on the gateway and the server 
can override it with retry- Interval. ^ „ ^ »™~r.« 

. AbortTransferMossmg*: The FT Gateway sends this message. If the transfer needs 

to be aborted before It has been completed. 

4.1.1 FT Transport Mechanism . . 

The FT Service Is designed to be secure and uses HTTPS as the * fa f^^^^\ TT - fA 
nutdenlsm. The FT Gateway uses a combination of basic ^f^fO^V^ HTTF >to 
communicate with FT Server via WebSeal. The transport protocol Is d^ded by the pr^ocoi 
• message. At the protocol layer, the transport mechanism Is transparent. Onh/ at 

of the message object, the object specifies which transport protocol to Use. With this model, 
any of the protocol messages can be switched from basic HTTP to SOAP over HTTP. 

4.1.1.1 B«slfc HTTP Transport 

This mechanism makes use of the HTTP protocol to communicate with the server , The 
attributes for a context are passed as the name-value pairs In the value of the HTTP context 
header. The values of the attribute names are encoded. 
X*e2open-<Context>: ottribute name value palrs> 

With this mechanism, multiple context headers can be sent to the server. The services can 
also set context properties to be sent through to the corresponding adapter. 

The message content Is sent as the payload of the HTTP request. The pay load length Is 
defined In the HTTP Content-Length header. The message definition is defined in the HTTP 
header Content-Type. 

4.1.1.2 SOAP over HTTP Transport 

This makes use of SOAP over HTTP to communicate with the server. Each Context is sent as 
a SOAPBodyElement and Um attributes are the XML elements In the SOAPBodyElement. 

The message content is sent as the attachment part (SOAP with Attachment). 

Currently only the TransferContextMessage uses SOAP over HTTP and ail other messages use 
basic HTTP. The message definition Is defined in the SOAP Action header. 
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was not chosen for all messages. In particular, ^^^^^^^^^'STfite chunk 
. reduced In a SOAP over HTTP Implementation. This message V™ " "L 

performs significantly. In basic HTTP transport, the chunk ength «s de^ed ln *e 
Contenting* header and there Is no MIME parsing involved In pa«*«ng the large chunk 
data. 

In order to use SOAP for this message, one would need to compensate ^is shortonMng 
" n MIME parsing. The fix will Involve specifying the length of the chunk In tne Contenting* 
hJTr ot tS MIME body part containing the attachment The MIME ^r -ha so n^ to 
be changed to lookup the length specified in the header and bulk read the bytes to get to the 
n?u?t!part delimiter, in light of this discussion, It should be obvious that ^SMPw 
HTTP for all messages will Involve additional time, effort and changes to^e basic MIMt 
parser. The basic HTTP transport mechanism has therefore been chosen for atl messages but 
one (for the exception, see below). 



Advantages of using SOAP over HTTP far certain messages it _ . 

SOAP over HTTP involves some additional overhead and parsing. However, basic HTTP has a 
4K limit on the size of the header. The TransferContextMessage passes a significant amount 
of information Including session cookies and context information. In order to accommodate 
the large amount of Information and provide for easy extensibility in the future, SOAP over 
HTTP has been chosen as the transport mechanism for this message. The message attributes 
are sent m the XML part and the transfer metadata as attachment Alternatively, onecould 
have used multipart/mixed, one port defining the session attributes and other the metadata. 

4.2 FileTastcInfo persistent cache 

The FT Service needs to transfer files In a guaranteed and reliable manner. For this, it needs 
to manage and maintain the state of transfer and other transfer information across the 
restarts of the service. FlleTasklnfo class Is used both by the FT Gateway and FT Server to 

achieve this. ^ , ^ 

a FlleTasklnfo object is created for each transfer operation. Every instance has a unique 
taskld. All information by this object Is managed in a directory created oy the class upon us 
creation. 

• For an upload operation the directory is 

${WORK_DIR}/<client / server>/<;userld>.lfVoutbox/<teskId> 

• For an download operation the directory Is 

$<WORK_DlR>/<cllent / server>/<userId>.lnyinbox/<taskld> 
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4.3 Transfer Operations 
4.3.1 Upload We Into E20pen 

The following sequence of steps occur when a file Is uploaded into 62open 

1. Client Initiates an upload file operation. This happens through one of the gateway 
services, which submit the upload transfer command to the Gateway. At this time the 
service may also pass some service specific data to gateway to he sent to the 
corresponding adapter. 

2. Gateway establishes a session by sending a TransferContextMessage to the server. 
^ Once the session is setup. Gateway starts sending ChunkRteMes&ages to the server, 

4, After all the chunks are received at the server, the server calls into the adapter with 
uploadFile in a separate adapter thread. 

5, Onre the gateway has sent all the chunks and received chunksCommlted for ail 
chunks from the server, it does one of the following 

a. If a response is needed from the adapter for the uploaded file, the gateway 
starts polling the server for the response with GetMessageResponse message. 
Once the response is available to the server, it sends the same to the 
gateway. Once the gateway has the response it calls Into the gateway service 
with the response and then proceeds to the next step. 

b, If no response is required from the server, the gateway sends 
EndTransferMessage to the server, cleans up the resources associated with the 
transfer. The server also deans up the resources associated with the transfer. 



4.3*2 Client Initiated download file from C20p#n 

The following sequence of steps happens to download a file from E20pen, 

1. Client Initiates a download file operation. This happens through one of the gateway 
services, which submit the download transfer command to the Gateway. At this time 
the service may also pass some service specific data to the gateway to be sent on to 
the corresponding adapter. 

2. FT Gateway establishes a session by sending a TransferContextMeasage to the server. 
The adapter prepares the file for being downloaded In a separate adapter thread. 

3. The FT Gateway then periodically checks with TransferContextMessage, If the file has 
been made available at the server to be downloaded. Once the file is available, 
transfer session setup ts complete, 

4. If the file for some reason cannot be downloaded, the server denies the download 
transfer operation to the gateway. 

5. Once the session is setup, the gateway starts downloading the file using 
ChunkFileMessage. 

6. After all the chunks are downloaded, Che gateway notifies the appropriate service with 
the downloaded file. 
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7. After the service has processed the file and lCHentService,downloadCompleted 
returns true, the gateway sends EntfTransferMessage to the server. It then deans up 
the resources associated with the transfer. 

4,3.3 Download file from E2op#n (push by E20pen) 

This feature is supported by Gateway only in the enterprise mode. This feature can be used 
to push files from E20pen to the dients. For this purpose, the gateway (which resides or* the 
client side) polls the server to check for files to be downloaded. In the current 
implementation, the files to be pushed to the gateway are put in the directory 
${WORKJ>IR}/perKHng/<userId.lfr> 

1. The gateway service registers with the gateway to poll the server If them are any files 
to be downloaded for a given user* 

2. The Gateway polls the server to check for files to be downloaded with 
GetDownloadMessage. When the server receives this message, it checks the pending 
download directory to check if there ore any fifes pending to be downloaded- If any 
such flies exist, then the files are moved to the Inbox directory and a transfer session 
Is created for the downloaded operation. The session Ids are sent back to the gateway 
in the response for GetDownloadMessage. 

3. On receiving a session Id, the gateway sends a TransferContextMessage for each of 

the session Ids. 

4. The step* after this point are the same as in client-Initiated download (steps 3, 4, and 
5). 

4.4 FT Gateway 

The FT Gateway is the client component of FT Service. It Is implemented as a standalone 
multithreaded Java application. The gateway can transfer multiple files concurrently 
(configurable) with multiple threads per transfer (configurable). A FiteTosklnfo (persistent 
cache object) object is created for each operation submitted to the gateway. This object ateo 
manages the state of transfer. 

A Client task is a task work that is executed by a worlcer thread. These worker threads are 
managed by gateway thread pool. 

A FileTransferTask (extends ClientTask) Is created for each transfer operation. This task 
basically manages the transfer session (login message, transfer context message, end 
transfer session). After the session is setup, It creates *n' ChunkhleTask's, where *n' is the 
maximum number of threads allowed for the transfer operation. Each ChunkFIieTask creates 
a ChunkFlleMessage and proceeds with the transfer of the file. On completion of the 
ChunkFiieTask, If more chunks are to be transmitted, another ChunKRleTBsk is created to 
handle the chunk* Once all the chunks are transmitted, the RleTransferTfcsk sands the 
EndChunkMessage and deans up the resources associated with the transfer. 
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The Gateway is designed to make sure that th file has been transferred reliably and every 
end point updated with the transfer status. Therefore a retry mechanism has been built into 
sevens! places- 

• If the server Is not available, the server will keep retrying, until the transfer's time-to- 
live expires. The retry Interval is configurable. 

• If the gateway Is stopped or Wiled while a transfer operation is in progress, on restart 
the gateway resumes the transfer operation from where it left off. 

• If the gateway is stopped or Wiled after an upload transfer Is complete but before It 
could fetch the response, on restarting it fetches the response and notifies the 
gateway service with the response. 

• If the gateway service returns false on ICIientservice.i/p/oa^mp/etecf callback, the 
gateway win keep retrying till it return true, (This may be of use If the service needs 
to contact some other process or server to complete this call, and tfce process/server 
may not be available). 

4,4.1 FT Gateway Services 

A FT Gateway service Is used to customize FT Service for transfer of files tor a specific need. 
Services are loaded up and initialized when the FT Gateway starts. The services are specified 
in the services.properties configuration file. The service uploads and downloads files from 
E2open using the FT Gateway instance* 

A FT Gateway Service implements the com.e2open.lft.cllent.servlce.lclIentService 
Interface (defined In Appendix). 



4.5 FT Server 

The FT Server is implemented as a serviet and can be deployed in any servlet container. 
Each request from the gateway is validated and processed. It maintains and manages a 
transfer session for each transfer operation In progress. All sessions make use of FileTasklnfo 
to manage transformation across restarts. It also manages a thread pool for adapter tasks. 
All callbacks into adapter are made by In these adapter threads. 



4,5.1 FT Server Adapter 

A FT Server Adapter is used to customize the FT Service for transfer of files for a specific 
need. There Is an adapter for every gateway service (both the adapter and the service have 
same name). All the adapters are loaded and initialized when the server Starts up. The 
adapt™* are defined in the configuration file adapter. properties, 

The FT Server adapter implements the interface 
cAm.e2opdn.irLftervenadaper,IserverAClapter. 
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S Use Case 

S.l Thin FT Client 

Thin Client File transfer solution uses thin dient service with FT Gateway. This solution is 
shrink wrapped as an application that gets Installed on a users desktop or laptop (currently 
windows only). The sequence of steps Is as follows. 

■ User logs Into E20pen Collaboration Manager. Navigates to a folder and dicks on the 
file upload/checkin or download/checkout link. 

■ User starts the Thin FT application. The application can be configured to automatically 
start when the user logs into Windows. 

- User chooses to transfer the file using FT application. 

• A hidden signed applet in the browser page submits the transfer request along with 
metadata about the folder, document etc to the FT application* 

■ The thin FT service processes this request end submits the transfer task to the FT 
Gateway. The transfer operation now proceeds in the background. 

• If the user chooses to encrypt the document while uploading, the thinFTService 
encrypts the document with a symmetric key for the CM Workspace (torn user's local 
key store. If the user is downloading a encrypted document the thinFTService will 
decrypt the document with the appropriate key from the user's local key store. 
Additional Information on this feature can Ue found in CM Secured Document Solution- 

■ For an upload operation, the file is checked Into CM by thinFTAdapter. 

• For a download operation, the file Is checked out from CM by thinFTAdapter, Once the 
file Is on the dient side, the thinFTService moves the file to the destination directory 
chosen by the user. 



5.2 PDM Integration 

PDM Service along with the FT Gateway Is deployed on the edge box. The sequence of soaps 
is as follows. 

- The PDM service polls a spool directory for files to be transferred into CM. 
« The file Is packaged as a PCOX document (XML format defined by E20pen)* 

• The PDM service submits the document to be transferred to the FT Gateway. 

► At the transfer session setup time, the PPM adapter verifies the user Id from the 
document name. 

• Once the session r? setup, FT Gateway transfers the document to the server. 

• FT adapter parses the PCDX document, extracts the file to be checked in and 
completes the upload operation into CM. 

■ FT adapter generates a response XML document. 

• FT Gateway polls for the response document/ retrieves It and delivers It to the PDM 
service. 

• PDM service moves the response document to the response directory to be consumed 
by customer 'a auplioaliun* 
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Tor additional information, refer to Sd&scopo PC-Integration Design document. 



5.3 Deployment Diagram 




6 Appendix 

6.1 rr Gateway Service Interface 

* Interface for the FT Gateway service. 
V 

public Interface ICHentService 
i 
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* Initialize the client service. This method la called Into the service when 

* ServiceManager Is Inttalizing this service. At this time the Gateway has not 

* yet stated, and so no transfer related activity happens. 

* &pararn pManager a refernca to the ServiceManager Instance. 

* ® pa ram pServiceName name of this service. 

* @param pConfigLoc the config file for this service. 

* ©throws ServiuaEAception the service should throw this exception if it 

* could not initialize. 
*/ 

puWic void inlttallze(XSenriud*tf itog^ pManager, 
String pServiceName, 
String pConfigLoc) throws ServiceException; 

/»* 

* Returns the name of this service 

* ©returns name of this service. 

*/ 

publk String getServiceNameQ; 



/** 

* start the service. TWs is a callback from the ServiceManager into this 

* service when this service Is being started- Trie service Implements this 

* method the procedure to start this service. 

* ©throws ServiceException the service throws this exception If it failed 

* to start 
*/ 

public void start() throws ServiceException; 

* Callback from FT Gateway into the service with the tasklist at Initialize 

* time. 

* ® pa ram pTaskUst list of task pending at the initialization time. This is 

* task list which the FT Gateway is going to process Jhe service 

* does not need to resubmit the task. 
*/ 

public void lniHalTaskUst(ArrayUst pTaskUst); 
/** 

* This callback is received by this service when the FT Gateway is 

* shuting down. Here the service needs to implement procedure for shutting 

* down the service, cleanup etc. 
V 

public void shutdownQ; 



Copyright © 2UU2 E2open LLC. Proprietary and Confidential 



E20pen Collaboration Manager 



* This callback is received by a service if the transfer 

* operation was denied by the FT Server (E2open) for some reason* 

* @ pa ram pTaskld the taskld of the transfer operation- 

* ©param pRlename the name of the ft la to be tr^nsfered. 

* <$pparam pKeasonStr description of tN? fdituie. 

* ®param pReason error code for transfer denial. 

public void transfferDenied{5tnng pTaskld, 
String pRlename, 
String pReasonStr, 
int pReson); 



* This callback invoked on completion of upload task. 

* Qparam pTaskld the taskld of the transfer operation. 

* @ pa ram pTransferfile complete name or the tile in transfer. 

* @param pResponseflle the response file 

* ® pa ram pResponseStatus status. 
* 

* ©returns the service should return true if the service was able to 

* handle the callback. On completion of this callback, 

* the FT Gateway will marie this task serviced and will dean 

* up the task. If the service returned false, then the Gateway 

* will try to service the call again at a later time. 
•/ 

public boolean uploadCompleted(Srrlng pTroAcTri, 
String pTransferFile, 
String pServtceData, 
String pResponseFlle, 
String pResponseStatus); 



* Callback received on the completion of a download. 

* dparam pTaskld the taskld of the transfer operation. 

* Qparern pRlename the final complete name of the file downloaded. 

* ® param pTransferFileoame the physical file that represents the downloaded file. 

* Oporom pScrviccData service data assocaited with thta tacldd. If any. 

* This is the cache data set by the service 

* for this task. 
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* ©returns the swvlcw should return true if th* service was able to 

* handle the callback. On completion of this callback, 

* the FT Gateway will mark this task serviced and will clean 

+ up the task. If the service returned fhbe, then the Gateway 

* will try to service the call again at a later time. 
*/ 

public boolean down!oadComptetjed(Str1ng pTaskld, 
String pRIename, 
String pTransferf ilename, 
String pServlceData); 

/** 

* Get the copymnctor for this task. 

* For a file being uploaded, the service can specify if the file needs to be 

* copied In FT Gateway cache for transfer. If the file needs to be copied to the 

* cache, then the Gateway calls into the service to get CopyFunctor. 
* 

* ©pa ram the taskld for which this callback is made, 

* ©returns copyFuntor used to make a copy ot the hie. if the service want to 

* use the default mode of copy (plain file copy), it should 

* return null. The service can Implement ICopyFunctor to 

* to specialize the the copy function, i.e. compress the file 

* while copy, encrypt the file while copy etc. 
*/ 

public ICopyFunctor getCopyFunctor( String pTaskld); 

> 



6.2 Server Adaptor Interface 

* Inteface to Implement adapters for LFT Server. 

* Each adapter has a name. The name of the adapter Is passed as the name 

* in the application context 
•/ 

public Interface IServerAdapter 

{ 

initialize the adapter 

* @param pName name of this adapter. This name is picked up from 
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* the adapter list file adapter. properties 

* @param pConflgFHe the config file for this adapter. 

* ©param pAdapterManager Manager Interface that the adpater could cache for 

* for later use. 
* 

public void lnitiatize(Strtng pwame, 
String pConflgFile, 
IAdapterManager pAdapterManager) 
throws AdapterException; 

/** returns the name of this adopter. */ 
public String getAdapterName(); 

/** shutdown the adapter. This method fe called before the server Is going down */ 
public void shutdownQ; 



/** 

* The call is made the the server Into the adapter to validate the request 

* for a transfer operation. This call is made before the session is setup 

* for the transfer. 

* ©param pSessionld - taskld for the transfer session to be established 

* ©param pRlename - name of the file In transfer 

* @param pHfeSize - size of the file. 

* ® returns true if the session can be setup. 
V 

public boolean vaiidateUpload (String pSessionld, 
String pFilename, 
long pHleStee) 
throws AdapterException; 

public boolean validatcDownload(String pSessionld, 
String pRIename) 
throws AdapterExceptlon; 



/** 

* This, inethod called In by the server Into the adopter after the file has boon 

* uploaded on the server. The adapter needs to handle the file in this 

* method. 

* ©pdiorn pSessionld the transfer id associated with this transfer 

* @param pTaskSubmitTime the time at which this task was submitted to the 

* gateway 

* <S>param pTraitsfcrflleitame the transfe file name of uploaded file. 
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* @param pFllename the uploaded file name 

* ®param pServtceData date sent by the Ift service (dient side) 

* ©param pAdapterOata data set by this adapter tor this task. 

* This is the data that the adapter could heve set while 

* validating the transfer request. 

* ©returns true If the adapter handled the upload successfully else return false. 
*/ 

public boolean uploadFlle(Strtng pSesslonld, 
long pTaskSubmitnme, 
String pTransferFitename, 
String pFllename, 
String pServfceData, 
String pAdapterOata) 
throws Adapter-Exception; 



* @param pSesslonld the transfer Id associated with this transfer 

* ©param pTransferFilename the transte file name of uploaded file f 

* $param pFilename the uploaded file name 

* @param pServfceData data sent by the Ift service (client side) 

* ©param pAdapterOata data set by this adapter for this task. 

* Thi* is the data that the adapter could have set while 

* validating the transfer request. 

* ©returns true If the adapter handled the upload successfully else 

* return falsa. 
V 

public boolean downloadFilc(String pSacslonld, 
long pTaskSubmitTime, 
String pTransferFilenanne, 
String pRlename, 
String pServleeData, 
String pAdapterOata) 
throws Adapter€xception; 



*/ 

public boolean downloadComplete(Strlng pSesslonld, 
String pFllename, 
String pAdapterOata) ; 
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* callback on transfer being aborted by the client 
V 

public void trartsf^Aborted(String pSessionld, 
String pFUename, 
String pAdapterData); 

> 

63 SarviceManager Interface 



* Interface for ServlceManager. 
*/ 

public interface IServlceManager 

* A service Invokes this function to upload a file ro F2open. This method 

* only submits a upload operation to the FT Gateway, 

* @pServioe the service invoking this function, 

* <$pUserid the userld used to authenticate this transfer 

* @pPasswd the password used for authenticating pUserld. 

* ©pFllename complete path to the file that is to be uploaded. 

* @pNccdsResponac docs this uplood needs a response from the 

* corresponding adapter. 

* <$pCopyRte If set true, the the Gateway will make a copy of the 

* file for transfer. If false, the the same physical file 

* will be used for transfer. 

* @ returns the taskld for the transfer operation. 

*@throws LFTException if the upload tiaiisfer could not be submitted. 
*/ 

public String uplaadFile(iafentServlce pServlce # 
SliJny pUserlU, 

String pPasswd, 

String pFIIename, 
boolean pNeedsResponse, 
boolean pcopyFile) 
throws LFTException; 



A service invokes this function to upload a file to fciopen. This method 

* only submits a upload operation to the FT Gateway. 

* ©pService the service invoking this function. 
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* ©pUoorld the userld used to auUieriUcate this transfer 

* ©pPasswd the password used for authenticating pUsertd. 

* ©pFllename complete path to the file that is to be uploaded* 

* @pAppData application data that needs to sent to the adapter along 

* with this upload operation. 

* ©pNeedsResponse does this upload needs a response from the 

* corresponding adapter. 

* @pCopyRle if set true, the the Gateway will make a copy of the 

* file for transfer- If false, the the same physical file 

* will be used for transfer. 

* ©returns the taskld for the transfer operation. 

*@throws LFTException if the upload transfer could not be submitted. 
V 

public String UploadFile(ICIIentService pService, 
String. pUsertd, 
String ppasswd, 
String pFilename, 
String pAppDato, 
boolean pNeedsResponse, 
boolean pCopyFile) 
throws LFTException; 



* Invoked by service to download a file from the service. 
*/ 

public String downtoadPlle(ICIlentService pService, 
String pUserld, 
String ppasswd, 
String pFilpname) 
throws LFTException; 

/** 

* Submit a request to download file from the server. A service uses this 

* method to initiate a download request from the server. 

* dparam pService the service submitting this request. 

* ©param pUserld the Userld for the download operation. 

* @param pPesswd the passwd for this download operation. 

* @ pa ram pRIename the local file name for the flic to be downloaded. 

* ® param pAppData the application meta data for this download op, 

* If set, this meta date is sent to the FT server. 

* FT Server delivers this meta data to the adapter 

* associated with this service, at the time when 

* the download session te being established. 
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* ©throws LfTBcception if tha inquest submission felled for some reason. 
*/ 

public String downloadFile(ICllentServlce pService, 

String pUserld, 

String pPasswd, 

String pRIename, 

Siring pAppData) 
throws LFTException; 



/** 

* Invoked by a service to abort a transfer. 

* (J&param pservice me service requesting this operation. 

* ®param pTaskld the taskld of the task to be aborted. 

* ©returns true If the task was aborted with success. 

* ^throws u-TExoeption if an invalid/inactive taskld was provided. 
V 

public boolean abortr ransfer(IdientServlce pService, 
String pTaskld) 
throws LFTException; 

* Suspend the task with the task Id. 

* @parma pTaskld taskld of the task to be suspended. 

* ©return true if the task was suspended with success. 

* ©throws LFTException if an invalid/inactive taskld was provided. 
*/ 

public boolean suspendTransfer(IClientService pClientServlce, 
String pTaskld) 
throws LFTException; 

* Resume a suspended file trnasfar operation 

* ©parma pTaskld taskld of the task to be resumed. 

* ©return true If the task was resumed with success. 

* ©throw?; LFTCxceptfon If an Invalid/Inactive taskld was provided. 
*/ 

public boolean resumeTransfer(iaientServioe pClientServlce, 
String pTaskld) 
throws LFTException; 

/** 

* In enterprise mode, a service can register with the FT Gateway to poll 

* for files to be downloaded from the server. This is useful If B20pen 

* wants to push files to the Customers. The FT Gateway will poll at regular 
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* (configurable) interval to check if there are files that needs to be 

* downloaded. 

* @pa ram pUserld the userld for whom to poll for download. 

* Qparam ppaeswd the password for this userld. 
*/ 

public void downloadPollFdrU8er(String pUserld, 
String pPasswd); 

* Shutdown the complete gateway. 

*/ 

public void shutdownGatewayQ; 



* Set set vice data foi 0 task. A Service can set some service data for a 

* particular task. The data can be ret reived with getServlceData method. 

* Once set, this information Is available to the service across restarts. 



* ®param pService 

* dparam pUserld 

* @param piasKId 

* @param pServiceData 

* @ throws LFTExceptlon 



the service that wants to set the data, 
the Userld associated with the task, 
the taskld on which this data Is be set* 
the data that needs to be cached for this task 

if the data could not be set. 



public void set5ervlceData( ICIIentService pService, 
String pUserld, 
String pTaskld, 
String pServiceData) 
throws LFTExceptlon; 

/*♦ 

* get the service date set by this service for a specific user and 

* specific task 

* @ pa ram pService the service that wants to get the data. 

* Oparam pUserld the Userld associated with the task. 

* Oparam pTaskld the taskld on which this data was he set. 
* 

* ©throws LFTExceptlon if the data could not be retreived. 
V 

public String getServk»Data(ICIientService pService, 
String pUserld, 
String pTaskld) 
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throws LFTException; 



* Get TasWnfbramtlon object associated with a particular task. 

* ©peram putrid the Usertt associated with the task. 

* @param pTaskld the taskld whose RleTasklnfb is be retrelved. 

*/ 

public IFileTasklnfo getRleT*sklnfb(String pUserld, 

String pTaskld) 

throws UTExcepoon; 



* Get list of ail submitted task. 
*/ 

public ArrayUst getAUSubmtttedTasks(); 



/** 

* set the transfer progress listener for a specific transfer 

* A service can register a Progress Listener to get information on transfer 

* progress. 

* ffloaram pService the service registering the listener. 

* (gJparam pUstener the listener to be registered. 

* tiftthmws i_f=TEXC«prinn 
V 

public void setTr^nsferProgressUstener(iaientServlce pService, 

TTransferProgressListanor pListener) 

throws LFTException; 
/*♦ 

* Register the exception listener for the service. 

* A service can register a Exception Listener to get exceptions on the task. 

ale 

* ©pararn pService the service registering the listener, 

* @param pustener the listener to be registered. 

* ©throws LFTException 

V 
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public void reglsterExcepUoiiUstwer^ICIIentServIc^ pService, 

IExceptlonLlstener pUstener) 

throws LFTException; 

> 



6*4 AdapterManager Interface 

public interface IAdapterManager 

public static final int STATUS NORESPONSE • 0; 
public static final int STATUS_SUCCESS 1; 
public static final Int STATUsIeRROR * 2; ' 

/** 

* A adapter can use this method to set some data on the taskld. This date 

* will be passed back to the adapter In the IServerAdapter.uploadFlla and 

* IServerAdapter.downloadfile callbacks- 

* ©param pAdapter the adapter Intance that is invoking this method. 

* ©param pSessionld the taskld of the transfer for which this method Is 

* Is called. 

^® param pData The adapter data that needs to be persisted for this task. 

public void setAdapterTaskData(ISeiverAdapter pAdapter, 
StHng pSessfonld, 
String pData) 
throws LFTExceptlon; 



* A adapter can use this method tu bsi some data on the taskld. Tills data 

* will be passed back to the adapter In the IServerAdapter.uploadRle and 

* IServerAdapter.downloadFlle callbacks. 

w ® param pAdapter the adapter fcilartce that Is Invoking this method. 

* ©param pSesslonld the taskld of the transfer for which this method is 

* is called. 

^©parani pResponsefllename The response filename for this request, If any. 

public void setTaskResponseFile(IServerAdapter pAdapter, 
String pSessiOMd, 
String pResponseRlename, 
lot pStatus) 
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throws LFTExcepdon; 



public String submltf r llePQrDownk>ad(IS«rverAdapter pAdapter, 

String pToUsertt, 
String pRIename) 

throws LFTEXceptlon; 

> 



Copyright # 2002 E2open LLC Proprietary and Confidential 



